Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions That Modify Movie Properties / Working With Movie Spatial Characteristics

GetTrackBoundsRgn

The GetTrackBoundsRgn function allows the media to limit the size of the track boundary rectangle. Therefore, the region returned by GetTrackBoundsRgn may not be rectangular and may be smaller than the track boundary region.

pascal RgnHandle GetTrackBoundsRgn (Track theTrack);

theTrack

Specifies the track for this operation. Your application obtains this track identifier from such Movie Toolbox functions as NewMovieTrack and GetMovieTrack (described on page 2-136 and page 2-188, respectively).

DESCRIPTION

The GetTrackBoundsRgn function allocates the region and returns a handle to the region. Your application must dispose of this region when you are done with it. If the track does not have a spatial representation during the specified segment, the function returns an empty region. If the function could not satisfy your request, it sets the returned handle to nil.

ERROR CODES

invalidTrack

-2009

This track is corrupted or invalid

Memory Manager errors

SEE ALSO

See the description of the base media handler component's MediaGetSrcRgn function in Inside Macintosh: QuickTime Components for details on how the media limits the size of the track boundary region.